home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Workbench Design
/
WB Collection.iso
/
workbench werkzeuge
/
dateimanager
/
mtool
/
docs
/
mfind_gb.doc
< prev
next >
Wrap
Text File
|
1996-04-07
|
6KB
|
180 lines
MultiFind
V1.0
25.4.1994
- Public Domain -
MANUAL
1. Introduction:
MultiFind is a "real" public domain program. There's no limitation
on its use - change it, sell it, eat the disk, just like you want.
If you want to spread it please include the source code and this
manual.
You're using MFind on your own risk. I'm cannot be held liable
for any damage caused by MFind. This includes user mistakes, system
crashes and any side effects.
MFind has been written for the use with my directory utility MTool.
But it can also be used "stand alone" or included in other programs.
Please report any bugs, so I can remove them!
If you improve MFind, please send me the result. This manual is a
"quick and dirty" translation from the German docs. I didn't want
to postpone the release of MTool 2.0c any longer by doing a more
careful translation. Sorry for that.
Boris Jakubaschk
Neue Straße 14/1
70186 Stuttgart
Germany
++49 711 462989
FIDO 2:246/1115.2
EMail Boris@alice.tynet.sub.org
Many thanks to:
- Matt Dillon for DICE
- Jan van den Baard for GadToolsBox
2. What is it good for?
Have you ever "lost" a file on your hard drive of even a disk?
You remember it was a letter for aunt Mary - but what was the
file name? Or you know it must be "MaryLetter3.TXT", but it
has moved to a drawer where you would search it at last...
That's a job for MultiFind: You can look for file names (or
patterns) or parts of the file contents. MFind searches in all
directories you have selected, if necessary all over the hard
disk. This is done very quickly, even while searching in
files.
Everything is controlled by a graphical user interface. All
files that match the search pattern are displayed in a list
view. You can select entries from this list, transfer the
path names to the clipboard or call an editor that displays
the file and jumps to the word you have looked for. A future
version of MTool will be able to use the results of MFind,
too.
3. How to use it:
After having started MFind, you see a window with two big list
views, a string gadget at the top and some other gadgets. The
list view at the left side will display the file names that
have been found, the other one holds the path names to search.
Let's start at the top of the window: The string gadget holds
a file name pattern, an ASCII string or a sequence of bytes in
hexadecimal notation, according to the cycle gadget behind it
and the "HEX mode" switch below. The other switches are used
as follows:
- only file names: Only active when searching for file names.
If selected, MFind compares the pattern only with the
file name, not with its path. If you input "#?info#?"
as a pattern, MFind will find "Work:taskinfo/main.c"
only if this switch is off, because "info" is a part
of the path and not of the file name.
- case sensitive: If selected, MFind won't find files with
the right name but a different case of some chars.
- subdirectories: Normally, all sub directories of the
selected directories are searched. To prevent this
(i.e. to search only in the base directory), this
switch must be off.
To select the directories to be searched, you must click on
"New" on top of the right list view. A file requester will
show up, where you can select the desired directory. If
you want to remove an entry of this list, select it and
click on "Del" then.
Now you are ready to start the search by pressing "Start".
You can "Stop" it whenever you want. The names of all files
that are found are displayed in the right list view. When
starting a new search, the list is not cleared automatically.
You can do this by pressing "Clear".
4. What now?
There are three options what to do with the file names
displayed in the left list view. The belonging gadgets
are below the list:
- MTool: The directory of the file is displayed in the
active file list and the file is selected. This will
be possible with MTool V2.2, because the ARexx port
is not yet implemented.
- Clipboard: The file name (including path) is put to
the clipboard, so you can paste it to a Shell with
Amiga-v.
- Editor: An editor is started, the file is loaded and the
cursor jumps to the position of the first occurrence of
the search string (if search has been for file contents).
5. Configuration
MultiFind can be adapted to your environment. When you start
it from Workbench, you can use the following tool types. From
Shell, you can put the tool type strings in the command line:
ED_Cmd=<file name>
- Name of the editor. Put a "%s" where MFind should insert
the file name. Default: "EDC %s".
ED_Port=<ARexx port>
- Name of the editors ARexx port. Default: "rexx_ced"
ED_RxCmd=<ARexx command>
- Arexx command to execute when jumping to the first
occurence of the search string. The offset must be
replaced by "%d". Default: "Jump to byte %d".
MT_Port=<ARexx port>
- unused. Default: "rexx_mtool".
MT_RxCmd=<ARexx command>
- unused. Default: "Get dir actual %s".
PATHSFILE=<file name>
- Text file containing the names of all paths to include
in the right list view at startup. So you can call MFind
quite easy from MTool. Just include it as a program object
with "PATHSFILE=%s" as the argument string. The argument
type must be set to "Source paths as file". MTool will
then pass all selected files and paths to MFind when you
call it.
6. History
V1.0 - 25.04.1994 (released together with MTool V2.0c)
NEW:
- Horizontal scrollers
Known bugs:
- Dir utility control theoretically implemented but untested
because MTool still has no ARexx port.
- Problems with GoldEd.
V1.0ß - 12.03.1994 (unreleased)